Skip to main content

事件推送

注册回调即可实时接收机器人事件报警，新增集团客户推送支持。

  • 兼容性：2025‑05‑15（含）之后新建或重新保存的订阅将采用本文描述的 新顶级字段格式。
  • 已生效的旧订阅保持两级结构（appId + payload），功能不受影响。
  • 新顶级字段（与 appId、payload 同级）。

回调注册要求

  1. 语言：符合 IETF BCP 47（如 en-US、zh-CN）。

  2. 回调：

    • url 例如 https://{{host}}/callback，HTTP 方法 POST。
    • appId 例如 24416c36-d9c7-4d74-a047-d6ca461fxxxx（用于鉴权。由高仙签发后提供）。

示例（新格式）

curl -X POST "https://{{host}}/callback" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "24416c36-d9c7-4d74-a047-d6ca461fxxxx",
    "payload": {
      "serialNumber": "ITEST00-0000-000-XXXX",
      "modelTypeCode": "Scrubber 50H",
      "content": {
        "incidentCode": "20005",
        "incidentName": "污水箱已满，请排污水",
        "incidentLevel": "H2",
        "incidentId": "d3919667-a9ce-463e-8d3e-4203c89bddcx",
        "incidentStatus": 1,
        "startTime": "2026-03-26T00:17:25Z",
        "endTime": "",
        "taskId": null,
        "subTaskId": null,
        "taskInstanceId": "",
        "taskName": "地面清洁",
        "mapId": "fc8101e8-626a-4a32-9ee6-c63d9871290x",
        "mapName": "大厦二层",
        "navInstanceId": null,
        "navName": null
    }
}'

顶级字段说明

字段类型描述
appIdString用于鉴权，保持不变
payloadObject业务数据，结构与旧版保持一致

参数描述：

字段名称字段类型字段描述示例
payload.serialNumberString机器人序列号"TEST00-0000-000-XXXX"
payload.modelTypeCodeString机器人型号代码"Scrubber 50H"
payload.contentObject事件内容
payload.content.incidentCodeString事件代码"1011"
payload.content.incidentNameString事件名称"Clean water full"
payload.content.incidentLevelString事件等级"H2"
payload.content.incidentIdString事件ID"c084a905-597e-4085-90dd-ecab697dxxxx"
payload.content.incidentStatusint事件状态，1 报警，0 恢复1
payload.content.startTimeString事件开始时间，UTC时间"2023-01-14T02:09:28Z"
payload.content.endTimeString事件结束时间，UTC时间。如果事件未恢复，结束时间为空字符串"2023-01-14T02:09:28Z" 或 ""
payload.content.taskIdString事件发生时，机器人正在执行的任务id"c084a905-597e-4085-90dd-ecab697dxxxx"
payload.content.subTaskIdString事件发生时，机器人正在执行的子任务id"c084a905-597e-4085-90dd-ecab697dxxxx"
payload.content.taskInstanceIdString事件发生时，机器人正在执行的任务实例id"c084a905-597e-4085-90dd-ecab697dxxxx"
payload.content.taskNameString事件发生时，机器人正在执行的任务名称"task1"
payload.content.mapIdString事件发生时，机器人所在地图的id"c084a905-597e-4085-90dd-ecab697dxxxx"
payload.content.mapNameString事件发生时，机器人所在的地图名称"map1"
payload.content.navInstanceIdString事件发生时，机器人正在执行的导航实例id"da4b1ca9-dbfe-4dd2-bcbe-715c00904f0b"
payload.content.navNameString事件发生时，机器人正在执行的导航点名称"hop"
payload.content.incidentLevel：
值名称描述
H0事件这不是报警，仅是事件通知
H1状态埋点统计
H2状态机器人的常规状态，用户无需指导即可解决
H3警告不影响机器人任务，用户可以解决
H4协助，问题影响机器人任务，用户可以解决
H5隐患不影响机器人任务，用户无法解决
H6故障影响机器人任务，用户无法解决
H7质量问题严重故障